home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 52 / Amiga Format AFCD52 (Issue 136, May 2000).iso / -serious- / programming / c / icu-1.3.1 / icuapps / uconv / readme < prev    next >
Text File  |  2000-02-23  |  2KB  |  55 lines
  1. uconv
  2. =====
  3.  
  4. uconv demonstration example of ICU and codepage conversion.
  5. The purpose is to be a replacement tool for the UNIX iconv program, and
  6. to show how to use the class UnicodeConverterCPP.
  7.  
  8. Compiling
  9. =========
  10.  
  11. See the README in the parent (icuapps) directory.
  12.  
  13. Running
  14. =======
  15.  
  16. uconv converts files from one encoding to another. Just type uconv and it
  17. will tell you the usage. It works similar to the iconv found in UNIX98 
  18. compliant systems.
  19.  
  20. TESTING uconv
  21. =============
  22.  
  23. In the utf8 and charset  directories you can find some texts, which you can use to test uconv
  24. with. In the charset directory you can find texts encoded in different codepages. 
  25. Not all the codepages are supported by uconv yet, i.e. no euc* are supported.
  26.  
  27. Note on running the example in Linux/UNIX (1999)
  28. ================================================
  29.  
  30. The i18n support  in Linux isn't as good as it should be, so to display other
  31. than ISO-8859-x on your console means problems. But there is much work in
  32. progress to eliminate this. In the meantime, please have a look at the 
  33. "UTF8 and Unicode FAQ for UNIX/Linux":  http://www.cl.cam.ac.uk/~mgk25/unicode.html
  34.  
  35. To be able to display Unicode characters from far-away languages 
  36. you need a suitable font. The easiest is to use Roman Czyborra's free unicode
  37. font. The font is not beautiful, but useful for testing purposes. Have a look at: 
  38. "Proposal for GNU Unicode font" http://czyborra.com/unifont/. This is
  39. not a TrueType font so it won't work in Windows and on Macs.
  40.  
  41.  
  42. Note on TMAKE (and those strange *.pro files)
  43. =============================================
  44.  
  45. Maybe you noticed the *.pro file. This is a source-file for the
  46. Makefile-generator tmake, which was written by Troll Tech. 
  47. It works in both UNIX and Windows, but you need to have Perl 
  48. installed. More information can be found on 
  49. http://www.troll.no/freebies/tmake.html.
  50. Usage: tmake uconv.pro > Makefile
  51.  
  52. Hope this will get you going with the ICU library
  53.  
  54. Jonas Utterström <jonas.utterstrom@vittran.norrnod.se>
  55.